home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Development Platforms / Apple II / Apple II Sample Code / Sample Code Notes (ProDOS) / SCN16Aware < prev    next >
Encoding:
Text File  |  1990-06-24  |  2.7 KB  |  59 lines  |  [TEXT/pdos]
  1. Apple II
  2. Sample Code Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6. #16:    Aware
  7.  
  8. Version:    3.0                                                     June 1990
  9.  
  10. APW Components:    MPW Components:
  11.  
  12. Aware.c            Aware.c
  13. Aware.h            Aware.h
  14. Aware.rez          Aware.r
  15. Config.c           Config.c
  16. Event.c            Event.c
  17. Menus.c            Menus.c
  18. Globals.c          Globals.c
  19. Aware.Link         MakeFile
  20. Build
  21. Build.r
  22. Full.Build
  23.  
  24. Aware is intended to show how easy it is to make an application reasonably 
  25. AppleShare-aware without having to use network-specific routines or calls.
  26. It shows off the @ prefix of Apple IIGS System Software 5.0 and the GS/OS
  27. class 1 Open call.
  28. _____________________________________________________________________________
  29.  
  30. Aware is a very simple program that shows how to use the @ prefix and GS/OS 
  31. class 1 Open call to be network aware.  When Aware starts up, it gets the
  32. date and time it was last run from a configuration file, and when it quits,
  33. it updates the date and time fields in the configuration file.  There are
  34. menu items to allow you to force the configuration file to be loaded and
  35. saved.  The last run date and time are displayed as part of Aware's About
  36. dialog box.
  37.  
  38. The @ prefix is the name of the directory where configuration information can 
  39. be stored.  Its actual contents depend upon from where the application was 
  40. launched.  If the application is launched from a non-AppleShare disk, the @ 
  41. prefix is set to the directory containing the application (the same as prefix 
  42. 1).  If the application is launched from an AppleShare disk, the @ prefix is 
  43. set to that user's folder on the user volume of the file server (if there is 
  44. no user volume online, the @ prefix reverts to the directory containing the 
  45. application).  This method is useful for saving configuration information, 
  46. defaults, or preferences on a per-user name basis.  Note that if several 
  47. people are logged on to the same server with the same user name, and launch 
  48. the application from a server, they all access the same configuration file 
  49. (even though you use the @ prefix).  It is up to the users to log on with 
  50. different names if they want to personalize their configuration, defaults, or 
  51. preferences.
  52.  
  53. APW users need APW v.1.0, APW C v.1.0, APW Tools & Interfaces v.1.1, and
  54. Apple IIGS System Software 5.0.2 or later.  Three APW command files,
  55. Full.Build, Build, and Build.R allow you to perform complete or partial
  56. rebuilds of the load file Aware.  MPW IIGS users need MPW v.3.0, MPW IIGS
  57. Tools v.1.1, and MPW IIGS C v.1.0 or later.  The name needed by the MPW
  58. Build menu's Build option can be found in the MakeFile.
  59.